package com.micro.ai.files.config;

import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import io.swagger.v3.oas.models.security.SecurityRequirement;
import io.swagger.v3.oas.models.security.SecurityScheme;
import io.swagger.v3.oas.models.servers.Server;
import org.springdoc.core.models.GroupedOpenApi;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.List;

/**
 * Knife4j API文档配置
 * 
 * @author micro-ai
 * @since 0.0.1
 */
@Configuration
public class Knife4jConfig {

    /**
     * 全局OpenAPI配置
     */
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                .info(new Info()
                        .title("Micro-AI 文件服务 API")
                        .description("提供文件上传、下载、存储配置管理、文件夹管理等功能")
                        .version("v0.0.1")
                        .contact(new Contact()
                                .name("Micro-AI Team")
                                .email("support@micro-ai.com")
                                .url("https://micro-ai.com"))
                        .license(new License()
                                .name("Apache 2.0")
                                .url("https://www.apache.org/licenses/LICENSE-2.0.html")))
                .servers(List.of(
                        new Server().url("http://localhost:9002").description("本地环境"),
                        new Server().url("http://localhost:9000/api/files").description("网关路由")
                ))
                // JWT认证配置
                .addSecurityItem(new SecurityRequirement().addList("Bearer认证"))
                .components(new io.swagger.v3.oas.models.Components()
                        .addSecuritySchemes("Bearer认证",
                                new SecurityScheme()
                                        .name("Authorization")
                                        .type(SecurityScheme.Type.HTTP)
                                        .scheme("bearer")
                                        .bearerFormat("JWT")
                                        .description("请在下方输入JWT令牌（无需添加'Bearer '前缀）")));
    }

    /**
     * 文件附件管理API分组
     */
    @Bean
    public GroupedOpenApi fileAttachmentApi() {
        return GroupedOpenApi.builder()
                .group("1-文件附件管理")
                .pathsToMatch("/api/file-attachments/**")
                .build();
    }

    /**
     * 文件上传记录API分组
     */
    @Bean
    public GroupedOpenApi fileUploadRecordApi() {
        return GroupedOpenApi.builder()
                .group("2-文件上传记录")
                .pathsToMatch("/api/file-upload-records/**")
                .build();
    }

    /**
     * 存储配置管理API分组
     */
    @Bean
    public GroupedOpenApi storageConfigApi() {
        return GroupedOpenApi.builder()
                .group("3-存储配置管理")
                .pathsToMatch("/api/storage-configs/**")
                .build();
    }
}

